SUPPORT / SAMPLES & SAS NOTES
 

Support

Problem Note 55623: Secure Sockets Layer (SSL) handshake errors occur when you invoke the JBoss web application server and when the SSLv2Hello protocol is restricted

DetailsAboutRate It

SSL handshake errors occur during invocation of the JBoss web application server. This problem occurs when the SSLv2Hello protocol is not allowed or it is restricted.

The Apache HttpClient classes that are used by SAS to make some internal requests generate an SSLv2Hello message during the SSL handshake. This message is rejected if the SSL protocol is restricted or not allowed, (for example, if the protocol is limited to TLSv1 or higher: -Dhttps.protocols="TLSv1"). The restriction results in SSL handshake errors in the web application-server log, and SAS web applications do not initialize properly.

To work around this problem, make sure that SSLv2Hello is allowed as part of the SSL protocols. This workaround only enables the SSLv2Hello message during the handshake, but SSLv2 is not used otherwise. As an example, you can specify the following in the HTTP connector for JBoss:

sslProtocols="TLSv1, SSLv2Hello"

This problem only affects SAS® environments that use Java 6 or earlier. With Java 7, the SSLv2Hello protocol is no longer used.



Operating System and Release Information

Product FamilyProductSystemSAS Release
ReportedFixed*
SAS SystemSAS Web Infrastructure PlatformSolaris for x649.2 TS2M09.4 TS1M0
Linux for x649.2 TS2M09.4 TS1M0
HP-UX IPF9.2 TS2M09.4 TS1M0
64-bit Enabled Solaris9.2 TS2M09.4 TS1M0
64-bit Enabled HP-UX9.2 TS2M09.4 TS1M0
64-bit Enabled AIX9.2 TS2M09.4 TS1M0
Windows Vista for x649.2 TS2M0
Windows Vista9.2 TS2M0
Microsoft Windows XP Professional9.2 TS2M0
Microsoft Windows Server 2008 for x649.2 TS2M09.4 TS1M0
Microsoft Windows Server 2008 R29.2 TS2M09.4 TS1M0
Microsoft Windows Server 2003 for x649.2 TS2M0
z/OS9.2 TS2M09.4 TS1M0
Microsoft® Windows® for x649.2 TS2M09.4 TS1M0
Microsoft Windows Server 2003 Datacenter Edition9.2 TS2M0
Microsoft Windows Server 2003 Enterprise Edition9.2 TS2M0
Microsoft Windows Server 2003 Standard Edition9.2 TS2M0
* For software releases that are not yet generally available, the Fixed Release is the software release in which the problem is planned to be fixed.